package com.rolerealm.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.rolerealm.domain.entity.CharacterTagEntity;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 角色标签数据访问接口
 * 
 * @author RoleRealm Team
 * @version 1.0.0
 */
@Mapper
public interface CharacterTagMapper extends BaseMapper<CharacterTagEntity> {

    /**
     * 根据角色ID查询标签列表
     * 
     * @param characterId 角色ID
     * @return 标签列表
     */
    List<CharacterTagEntity> selectByCharacterId(@Param("characterId") Long characterId);

    /**
     * 根据角色ID列表批量查询标签
     * 
     * @param characterIds 角色ID列表
     * @return 标签列表
     */
    List<CharacterTagEntity> selectByCharacterIds(@Param("characterIds") List<Long> characterIds);

    /**
     * 根据标签名称查询角色ID列表
     * 
     * @param tagName 标签名称
     * @return 角色ID列表
     */
    List<Long> selectCharacterIdsByTagName(@Param("tagName") String tagName);

    /**
     * 根据标签类型查询标签列表
     * 
     * @param tagType 标签类型
     * @return 标签列表
     */
    List<CharacterTagEntity> selectByTagType(@Param("tagType") String tagType);

    /**
     * 查询热门标签
     * 
     * @param limit 限制数量
     * @return 标签列表
     */
    List<CharacterTagEntity> selectPopularTags(@Param("limit") Integer limit);

    /**
     * 根据角色ID删除标签
     * 
     * @param characterId 角色ID
     * @return 删除数量
     */
    int deleteByCharacterId(@Param("characterId") Long characterId);
}
